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INTRODUCTION 

The NOVA symbolic debugger. Debug III, is a program that interfaces with user 
routines as an aid in debugging. Debug III provides for up to 8 active breakpoints 
within the user's routines. The accumulators, carry, and memory can be examined 
and modified from the teletype after a breakpoint has occurred. The machine state 
can be monitored during execution of a routine using simple commands to the 
debugger from the teletype. The debugger interfaces with any NOVA routine, including 
those using the NOVA interrupt structure. The Stand-alone version of Debug III 
can also be used to punch ranges of memory in binary format acceptable as input to 
the Binary Loader. 

The following versions of Debug III are available: 

1.. Relocatable - No Disk Operating System (Stand-alone), 

2. Relocatable - Disk Operating System (DOS). 

The following differences exist between the two debuggers: 

1. Punch commands and certain register commands are meaningless in 

DOS operation and are therefore illegal. The commands involved are: 

$F 

n$F 

$E 

adr$E 

adr] < adr2$P 

$H 



punch commands 



$1 Interrupt register command 

$T TTI register command 

$L Location register command 

$Y Symbol table pointer register command 

2. Under DOS, all I/O is handled by the system. Therefore, the DOS 
debugger does not recognize I/O nmemonics (DIA, NIOS, DOAS, etc. ) . 
However, programmed system commands for I/O are recognized 
(.OPEN, .RDL, .CLOSE, .WRS, etc.). 

3. The $R command has a slightly different meaning in Stand-alone and DOS 
Debug III. The difference is noted in the writeup of that command. The 
$G and adr $G commands are only implemented in Stand-alone. 
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COMMAND SUMMARY 



The Symbolic Debugger provides extensive facilities for examining and modifjring 
program status. The single-character command code may be preceded by an 
argument. The argument is normally separated from the command code by the symbol 
$ or the escape code (ESC) which echoes $, In the command summary following, the 
argument may be null or one of the following: 



sym 
adr 



n 



adr, < adr 9 



name 



Command 

adr/ 

adr i 

J 

f 

$K 
n$K 

sym $K 

name% 



user symbol 

an address having any legal address format, such 
as an octal or decimal number, user symbol, 
or expression. An expression has the format: 

x+x+x . , . 

where each x is a symbol, octal, or decimal number 
separated from the following x by either + or - . 

an integer. 

a range of addresses from adr ^ to adi;) inclusive. 

a user symbol that is the name of a user program. 

Meaning 



Open register adr and type contents. 

Open register adr . 

Close open register. 

Close open register and open next. 

Close open register and open previous. 

Remove all local and global symbols from input and 
output. 

Remove all local symbols from input and output but 
retain (or enable) globals. 

Remove sym from output permanently. 

Enable all local and global symbols or restore to 
output all symbols removed by $K and n$K com- 
mands within program name. 



Pa ge Where 
Described 

7 
7 
7 
7 
7 

9 

9 

9 

9 
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COMMAND SUMMARY (Continued) 



Command 

$P 

n$P 

n$Q 

$B 

adi$B 
$D 
n$D 

$M 

$W 

$S 

adr$S 

adr < $S 

adri < adr2 $S 

$R 



adr$R 

$G 

adr$G 



$A 
n$A 

v$L 

$N 

v$Y 

v$T 
$C 



Meaning 



Page Where 
Described 
12 



Proceed from current breakpoint with break proceed 

counter set at +1 . 
Proceed from current breakpoint with break proceed counter 12 

set at n. 
Open break proceed counter n (n = 0-7). 12 



Print locations of all user program breakpoints. 

Insert breakpoint at location adr. 

Delete all breakpoints. 

Delete breakpoint n. (n=0-7) 

Open m^ask register. 

Open word register. 

Search all memory. 

Search memory locations to adn 

Search memory locations adq to 077777 inclusive. 

Search memory locations adr . to_ad^ inclusive. 

Restart program at address in location register 

(Stand-alone). Restart program at starting 

address in UST (USTSA) (DOS). 
Restart program at address adr. 
Restart program at address in location register 

and set C(AC3) to address of debugger. * 
Restart program at address adr , set C(AC3) 

to address of debugger. * 

Print all accumulator register contents. 

Open accumulator register n. (n = 0-7) 

Open interrupt register. * 

Open location register. * 

Open numbers register. 

Open symbol table pointer register. * 

Open TTI done register. * 

Open Carry and TTO done register. 



11 
11 
11 
11 

14 
14 
14 
14 
14 
14 

10 
10 

10 
10 

10 



16 
16 
16 
16 
16 
16 

18 
18 



*Only implemented in Stand-alone Debug III. 
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COMMAND SUMMARY (Continued) 



Command 

$F 
n$F 

$E 
adr$E 

adr , < adr9 $P 
$H 



& 



Meaning 

Punch 10 decimal inches blank tape. * 

Punch n (octal or decimal) inches blank tape. * 

Punch end block on tape. * 

Punch end block with transfer point adr. * 

Punch binary tape from location adr , to adr2 inclusive. 

Open search/punch output register. * 

Print last typed quantity in numeric form. 
Print last typed quantity in symbolic form. 
Print last typed quantity in instruction form. 
Print last typed quantity in half-word form. 
Print last typed quantity in ASCII form. 
Print last typed quantity in byte-pointer form. 



Page Where 
Described 

19 ' 
19 
19- 
19 
* 19 
19 

21 
21 
21 
21 
21 
21 



$= 
$: 
$; 

$• 



Print subsequent quantities in numeric form. 
Print subsequent quantities in user symbol form. 
Print subsequent quantities in instruction form. 
Print subsequent quantities in hiJf-word form. 
Print subsequent quantities in ASCII form. 
Print subsequent quantities in byte-pointer form. 



21 
21 
21 
21 
21 
21 



Only implemented in Stand-alone Debug III. 



SYMBOLS AND CONVENTIONS 



SYMBOL 



MEANING 



EXAMPLE 



+ 



Addition. 



NEXT+SUM+1 



Subtraction. 



SUM2-SUM1 



(Space) 



@ 



Separate instruction fields. 

Separate instruction fields. 

Add 1 n to data (used with 
source -destination accumu- 
lator instruction. ) 

Add 100000 to data, and add 
2000 to an instruction. 



LDA 



LDA 0,0,0, 



. ADC# 1 SZC=.. 106032 
V ^ ^\ 



command 



response 



@= 100000 

LDA @0 0= 022000 
(^ ' \ . ' 



Delimit beginning and end of a 
one character string; delimit 
beginning and, optionally, the end 
of a two -character string. 

Can be used as any character 
within a user symbol. 

Denote a decimal number. 

Can be used to represent the 
current location. In the example, 
AA is the current location symbol 
and the commands AA/ and . / produce 
identical results. 



command 

"A" 

"AB" 

"AB 



.PR2 
-5. 

AA/NEGO 
./NEGOO 



response 



SYMBOLS AND CONVENTIONS (Continued) 

SYMBOL MEANING 

* Conventional representation for 

pressing carriage RETURN key . 
This closes a memory register 
after examination and possible 
modfi cation. 

I Conventional representation for 

pressing LINE FEED key. This 
closes a memory register after 
examination and possible modifi- 
cation and opens the next con- 
secutive register. 

$ Conventional representation for 

the ESC key (although the $ 
symbol may also be typed by 
pressing the Shift and 4 keys). 
I $ delimits the argument from 

the command. (ABCB is 
ambiguous, ABC$B is not. ) 

A Symbol is used to close a memory 

register after examination and 
possible modification and open 
the previous register. 



EXAMPLE 



AA/NEG NEC 1 l^ 



AA/NEG 1 U 
AA+l/LDA FD2l| 
AA+2/STA 1 FDIO 



$S 
$L 



AA+2/STA 1 FDIO f 
AA+l/LDA FD21 



USER TYPING ERRORS 

The user can kill an incorrect command or typing error by pressing RUBOUT 
key. 



OPENING, MODIFYING, AND CLOSING MEMORY REGISTERS 
FORMAT MEANING 



adr! 
adr/ 

NOTES: 



EXAMPLES: 



ABC! 






Open register adr . 

Open register adr and print contents. 

Close most recently opened register. 

Close most recently opened register and open the succeeding 
register. 

Close most recently opened register and open the previous 
register. 

When a register is opened and a command is given that does 
not reference the register, the register is automatically closed. 
If $ is typed with a register open, the error message ? will 
be printed. / or ! remain in effect until changed when opening 
and closing registers repetitively using f and ^ . 



Open register ABC. 






AA/ADD SZC SUB 0, j^ ^ Register AA is opened, modified and closed. 



AA/ADD SZC SUB >^ 
AA+1 LDA 3-13 



Register AA is opened, modified and closed , and 
the next location is opened and its contents 
printed. (/ remains in effect during chained 
openings . ) 



AA/ADD SZC SUB 0, Ot ^ Register AA is opened, modified and closed, and 
A STA TR the previous location,A, is opened and its contents 

printed. 



AA/ADD SZC I 
AA+1 LDA 3 -1 3i 
AA+2 JMP BB 4 
AA+1 LDA 3 -1 3J. 



Series of openings and closing of sequential registers. 



OPENING. MODIFYING AND CLOSING MEMORY REGISTERS (Continued) 



EXAMPLES (Continued) 
AA/JMP BB/ADD 

AA/JMP BB = 000423 
AA/JMP BB .= 003000 



The second / closes register AA unmodified and 
opens a register via the 15 -bit C(AA). 



Register AA is still open. 

Register is closed by . = 
AA is 3000. 



The value of address 



REMOVING AND RESTORING USER SYMBOLS 

The symbol tables of the assembled programs loaded with the debugger contain the 
user symbols known to the debugger. These are the local symbols - those known 
only in a single assembled program - and the global symbols known throughout 
the loaded programs. 



FORMAT 



MRAKfTMH' 



$K 



Remove all symbols (local and global) from input and output. 
Absolute values are used instead. 






Remove all local Syiilbols fiOiii iiipUt aaid output but reta.iii ul' 

enable global symbols. Absolute values are used instead of 
local symbols, n is any single digit. 



sym $K 



name% 



Remove the user symbol named sym permanently from output. 
The user symbol having a value closest to sym is used instead, 
provided there is a user symbol within 2000^. 

Restore to output all user symbols previously removed from the 
program named name by n$K and $K commands, i. e. , enable 
all local symbols except any removed by a sym $K command. 



NOTE: 



EXAMPLES : 



Symbols are removed from output by the sym $K command but 
may still be used on input. If no local symbols have been loaded, 



)t5>piK will ciittuic ciii yiujjitia. 



Suppose that a program given in the title XX by the . TITL 
pseudo-op contains symbols C72, . FD40 and T2. Then: 



505/ LDA 1 C72 

C72$K 

50 5/ LDA 1 . FD4(>f7 

. FD40$K 

. /LDA 1 T2+23 

1$K 

. /LDA 1 +50 

xx7o 

505/LDA 1 T2+23 



In this example, each time a symbol 
is removed, the debugger substitutes 
the closest symbol with appropriate 
offset. When all local symbols are 
removed by a 1 $K command, an 
absolute value is substituted. The 
command XX% restores all symbols 
not permanently removed from output. 



STARTING AND RESTARTING A PROGRAM 

Four commands are available for starting and restarting a user program at a location 
other than a breakpoint. 

Two of the commands simply give a starting location. The other two commands pro- 
vide that AC3 will contain the address of the debugger at restart time, so that a return 
is made to the debugger if an instruction points to C(AC3). 



FORMAT 



$R 



adr$R 

$G 

adr$G 



MEANING 

Restart program at address given in location register, 
C($L). (Stand-alone Debug III). 

Restart program at program's starting address in User 
Status Table (USTSA, location 40|. ) . (Debug IE under DOS). 

Restart program at address given by adr. 

Restart program at C($L); set C(AC3) to address of debugger 
(Stand-alone Debug III). 

Restart program at address given by adr ; set C(AC3) to 
address of debugger. (Stand-alone Debug III). 



EXAMPLES: 

$L 000261 
$R 

7BBQ 
TOP$R 

USE4$G 



contents of location counter checked and user program 
restarted at that point if using Stand-alone Debug III. 

after a break, user restarts his program at a location TOP. 



user restarts program at a different location and sets 
the debugger location in AC3. 
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SETTING AND DELETING BREAKPOINTS 



The user can set up to eight breakpoints in his program. When a breakpoint is encountered 
during execution, the breakpoint causes a transfer to the debugger before the instruction 
at which it is set is executed. In effect, the setting of the breakpoint causes the program 
instruction to be transferred to the debugger and a JMP instruction to the debugger to be 
substituted in the user program, 

j_igiit \^'^^/ ii^vauuiio v^j. ^ciu iciui-ctLajjic uuut; axe reservea lor ine eignt cieDugger Creak- 
points. Any attempt to place other information in these locations and then execute will 
wipe out the user program. Breakpoint numbers are assigned in reverse numeric 
order: 7 6 5 ... 0. 



FORMAT 

$B 

adr$B 

$D 

n$D 

NOTES: 



EXAMPLES : 

$B 

7BTT 

6BTT2 

TT4$B 

$B 

7BTT 

6BTT2 

5BTT4 

6$D 

$B 

7BTT 

5B TT4 



MEANING 
Print locations of all breakpoints. 
Set a breakpoint at location adr. 
Delete all breakpoints. 

Delete breakpoint n where ii = 7 6 ... 0. 
See page 11 to resume execution after a break. 
Breakpoints should no^ be set at the following types of locations: 

1. Data words. 

2. Instructions modified during execution. 

3. Locations where interrupts cannot be delayed for relatively 
long times. 



command to print out existing breakpoints, 
response 

command to set a new breakpoint 



command to delete breakpoint 6. 
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ENTERING AND LEAVING THE DEBUGGER VIA BREAKPOINTS 



A user can set a breakpoint at a given instruction in his program, as described 
in "Setting and Deleting Breakpoints". Breaks are not visible to the user unless the 
STOP and EXAMINE switches on the operator's panel are used. During program 
execution a transfer is made to the debugger when the breakpoint is encountered. The 
instruction at which the breakpoint is set is not executed. The debugger prints 
the breakpoint number, the instruction address, and the current status of the accumu- 
lators. 

When the user has completed debugging and wishes to restart execution, he issues a 
$P or n$P. Execution resumes with the breakpoint instruction. The user, in resuming 
execution, can set the number of times the instruction at which the break occurred will 
be executed before the debugger is to be reentered. 



FORMAT 
$P 

n$P 

n$Q 
EXAMPLE: 



MEANING 

Set break proceed counter to +1 and proceed with execution from 
current break. Command $P is equivalent to 1$P. 

Set break proceed counter to n, where n is the number of times 
the instruction will execute before a transfer to the debugger 
occurs; proceed with execution. 

Open break proceed counter n, where n is 0-7, and print contents. 

Suppose a user program contains three breakpoints at symbolic 
locations ATOMl, ATDIG, and AT0M2. A partial listing might 
be: 



0001 1-006201 -ATOMl 

00012-000052- 

00013-024000- 

00014-106032 

00015-024001- 

00016-107046 

00017-000417 

00020-045407 ATDIG: 

00021-024002- 

00022-045402 

00023-021403 

00024-025404 

00025-006201- 

00026-000621 

00027-000001 



CALL 
CHAR 
LDA 1, C72 
ADCZ# 0, 1, SZC 
LDA 1, M60 
ADDO 0, 1, SEZ 
JMP AT0M2 



;ACO WILL CONTAIN THE 
;INPUT CHARACTER. 



;IS IT A DIGIT? 
;N0 



STA 1, ATEM,3 ;SAVE THE DIGIT. 

LDA 1, C12 

STA 1, NUMBfl,3 

LDA 0, NUMBf2, 3 ; FORM A NUMBER 

LDA 1, NUM&f3,3 ;FROM THE STRING OF DIGITS. 

CALL 

DMPY ;MULTIPLY PREVIOUS 

NUMB ;NUMBER BY 10. 



.1 0. 



ENTERING AND LEAVING THE DEBUGGER VIA BREAKPOINTS (Continued) 



00035-000754 

00036 -024003 -AT0M2: 

00037-106032 

00040-024004- 



JMP ATOMl 
LDA 1, CI 33 
ADC# 0, 1 SZC 
LDA 1, MlOO 



;IS THE CHARACTER IN 
;ACO A LETTER? 



Presume the user is in the debugger. He prints out his breakpoints and his current 
location: 

$B 



6B ATDIG 
SB AT0M2 

. /JMP AT0M2 

.= 417 

. : AT0M1+ 6 

ATDIG4-4$R 



) 



See Conversion Mode Commands. 



5B AT0M2 

000000 1 000000 2 001461 3 001522 



Debugger prints status information. 



5$Q 000001 3 
A<rrv nnr\r\c\'7 



Break proceed counter 5 is changed to 3. 



$p 



Execution resumed. Since 5$Q was 
changed to 3, this is equivalent to 
3$P. 



5B AT0M2 

000003 1 000000 2 001461 3 001522 



C(ACO) set to 3 by looping through 
breakpoint 5. 



100$P 



■<- Execute, looping through breakpoint 
100 times. 



5B AT0M2 

000103 1 000000 2 001461 3 001522 



C(ACO) set to 103 by 100 (+3) loops 
through breakpoint 5. 
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SEARCH COMMANDS 

Search commands allow all or part of memory to be searched for the contents of 
the word register $W, as modified by the contents of the mask register $M. 

The search algorithm is implemented as follows: 

1. The contents of each successive location is read from memory. 

2. The debugger performs a logical AND with this word and the contents 
of the mask register. 

3. The result of the logical AND is compared with the word register. 

a. If the words are equal, the true contents of the memory location 
are printed,based on the contents of the search/punch register 
$H. (See page 19, "Punch Commands. ") 

b. If the words are unequal, nothing is printed. 



NOTE; If $H = P00001, search output will be to the line printer. If print mode is 

instruction or numeric, search output will be in both modes; all other output 
modes will result in the single associated output. See page 19, "Punch 
Commands" and page 21, "Conversion Mode Commands. " 

FORMAT MEANING 

$W Open word register and print contents. 

$M Open mask register and print contents. A value of -1 (177777) 

indicates no masking of word register. 

$S Search from location to 77777 inclusive. 

adr$S Search from location to adr inclusive. 

adr < $S Search from location adr to 77777 inclusive. 

adri <adr2$S Search from location adr , to adr^ inclusive. 

NOTES: In Stand-alone mode, pressing any teletype key will cause the search to 
be aborted. 

To output all locations, $W and $M should = 0. 
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SEARCH COMMANDS (Continued) 

EXAMPLES: If the current contents of the word register = LDA 1, FIELD 

and current contents of the mask register = -1, then: 

$S <- might produce a response: 

FIE LDA 1 FIELD 
FIE2 LDA 1 FIELD 
FIE3 LDA 1 FIELD 

FIE3-DIM$S <- might produce a response: 

FIE LDA 1 FIELD 
FIE2 LDA 1 FIELD 

FIE2-2 < $S <: might produce a response: 

FIE2 LDA 1 FIELD 
FIE3 LDA 1 FIELD 

FIE2 < FIE3+SYN$S <■ might produce a response: 

FIE2 LDA 1 FIELD 
FIE 3 LDA 1 FIELD 

If the current contents of the word register = FIELD and the 
contents of the mask register = 0(^0377, then: 

$S -"Sr might produce a response: 

FIE LDA 1 FIELD 

FIE2 LDA 1 FIELD 

FOO ADDZR# 1 SZC <- Match on 8 bits if FIELD = 232 

FIE3 LDA 1 FIELD (Since ADDZR# 1 SZC = 103232). 

$W (6(i(i(t(}(i NEC ^ NEC loaded into word register. 

$M 000d(/)0 -1 «- Mask register loaded to permit 

search on NEG j0 field format. 
$S -^ A search will cause printout of all 

NEG instructions. 
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EXAMINING AND SETTING SPECIAL REGISTERS 



Some of the registers that are used for special purposes and can be altered by the 
user are: 

Accumulators to 3 . 

Symbol Table Pointer register which contains a pointer USTSS; USTSS is a User 
Status Table address (location 402) that contains a pointer to the beginning of the 
symbol table. The pointer to the end of the symbol table, USTES, is in location 
403 immediately following USTSS. The register is only meaningful for Stand-alone 
Debug III. 

Numbers register which determines whether numbers in the special registers will 
be interpreted as decimal (non-zero) or octal (zero). 

Location register which contains a starting location set by the user, to be used when 
a $R command is issued, provided no argument address precedes $R. The register 
is only meaningful for Stand-alone Debug III. 

Interrupt register which contains the status of Interrupt Enable. The register is set 
to -1 if interrupts are enabled when the debugger is entered. Otherwise, the register 
is all zeroes. The interrupt register is only meaningful for Stand-alone Debug III. 



FORMAT 

$A 

n$A 

$Y 

$N 

$L 

$1 
EXAMPLES: 



MEANING 

Print contents of the four accumulators. 
Open accumulator n (n = 0-3). 

Open symbol table pointer register and print contents. 
Open numbers register and print contents. 
Open location register and print contents. 
Open and print contents of interrupt register. 

$N 000000 ■«- numbers register contains all zeroes (octal). 

$A 000100 1 000040 2 000011 3 000017 

Number of the register is printed followed by the contents, given in octal. 
2$A 000011 00001 5^ ■<- AC2 is opened, contents altered to 000015, then closed 
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EXAMINING AND SETTING SPECIAL REGISTERS (Continued) 
EXAMPLES: (Continued) 

$N 000000 1 -^ user puts 1 in numbers register. 

$A +64. 1 +32. 2 +13. 3 +15. 

Contents of accumulators again printed, this time in decimal. 



$N 000001 

$L 000071 
$R 

$Y 000402 



numbers register modified to zero. 

contents of location register cliecked 
before resuming execution at that location. 

symbol table pointer register normally 
points to location 402. Contents of the 
register can be altered, however. 
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EXAMINING AND SETTING SPECIAL REGISTERS $T AND $C 

The teletype input register $T contains the status of teletype input. Bit is set to 
1 if teletype input is not done. The register contains the character if teletype input 
is done. The teletype input register is only meaningful for Stand-alone Debug III. 

The carry and teletype output register $C contains the current state of the carry 
flag and the status of teletype output. Bit is set to 1 if the carry flag is 1, bit 15 
is set to 1 if teletype output is done. 



FORMAT 



MEANING 



$T 
$C 



Open and print contents of teletype input register. 

Open and print contents of carry and teletype output register. 



EXAMPLES: 



User Coding 



$T and $C Register Status When Debug Entered 



A: 



SKPDN TTI 
JMP -1 
JMP DEBUG 



$T 



000101 



(A was typed) 



AMOD: SKPDN TTI 
JMP.-l 
DIAC TTI 
JMP DEBUG 



$T 



100000 



B: ADC Z 0,0 

DOAS TTO 
JMP DEBUG 



$C 



000000 



BMOD: ADCO 
DOAS TTO 
SKPDN TTO 
JMP .-1 
JMP DEBUG 



$C 



100001 



-li 



PUNCH COMMANDS 



FORMAT 



MEANING 



$H 



$F 
n$F 



Open and print contents of search/punch register. 

Bit = - Punch output is to teletype punch. 
Bit = 1 - Punch output is to high-speed punch. 
Bit 15=0 - Search ($S) output is to teletype printer. 
Bit 15=1 - Search ($S) output is to line printer. 

Punch ten inches of blank tape. 

Punch n inches (octal or decimal) of blank tape. A decimal point 
immediately following n indicates decimal output. 



$E 
adr$E 

adr^ < adr9 $P 
NOTES: 



EXAMPLES: 



Punch an end block on the tape. 

Punch an end block on tape with transfer to location adr when the tape 
is read in the binary loader. 

Punch in binary from address adr^ to adr^ inclusive. 

Any $P command that does not contain the symbol < will be interpreted, 
as a break proceed command (See page 11). 

The Debug III version used with the Disk Operating System does not have 
punch commands. 

$H 100000 ♦ high speed punch in effect; search output to teletype. 

40. $F -^-punch 40 decimal inches of blank tape. 

LTT <BRR$P *• binary punch from location LTT to BRR. 

LTT$E «6-punch end block and set binary loader to start at LTT. 

50$F ■«■ punch 40 decimal inches blank tape. 

$H 000001 «■ search output to line printer. 

$H 100001 «■ search output to line printer; punch output to high-speed 
punch. 



When using the teletype punch, ($H Bit = 0), the user must stop and 
start the punch to prevent debugging commands from being punched as 
shown: 

$H 000000 <- teletype pvmch in effect. 

$F <- punch 10 decimal inches blank tape. Computer 

HALTS with carry light ON. User then presses 
ON button on teletype and presses CONTINUE 
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PUNCH COMMANDS (Continued) 
EXAMPLES: (Continued) 



on the operator panel. 

When punch stops, the computer HALTs with 
carry light OFF. The user presses OFF on 
the teletype punch, presses CONTINUE on 
operator panel. 

.X< X3$P <- punch from .X to X3. User presses ON 

on the TTY and CONTINUE. 

When pvinch stops, user presses OFF on 
the TTY and CONTINUE. 

. x$E <r punch end block and set start for . X 

when the tape is read in. User presses ON 
on the TTY and CONTINUE. 

When punch stops, user presses OFF on 
the TTY and CONTINUE. 

8. $F ^ punch 8 decimal inches of blank tape. User 

presses ON on the TTY and CONTINUE. 

When punch stops, user presses OFF on the 
TTY and CONTINUE. 
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CONVERSION MODE COMMANDS 

There are six different formats in which information may be printed out, and a 
symbol associated with each format. 



FORMAT 



& 
$= 
$: 
$; 

$^ 
$• 

$& 

NOTE : 

EXAMPLES: 



MEANING 

Print last quantity in numeric format. 

Print last quantity in user symbol format. 

Print last quantity in instruction format. 

Print last quantity in half-word format. 

Print last quantity in ASCII characters. (The symbol is an 
ap)ostrophe or an acute accent. ) 

Print last quantity in byte-pointer format. 

Print information following in numeric format. 

Print information following in user symbol format. 

Print information following in instruction format. 

Print information following in half-word format. 

Print information following in ASCII format. 

Print information following in byte-pointer format. 

The default format for memory words is instruction format; the 
default format for accumulator and other special register contents 
is octal. 



INIT/JMP ABC :BUFF+3 =000777 ;JMP ABC -t- 1 370 ' < 1~> <370> & 000377 1 

The instruction at location INIT is printed out in default instruction format. 
Then in each subsequent conversion, the quantity printed last is converted 
to the requested format. 
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CONVERSION MODE COMMANDS (Continued) 

EXAMPLES: (Continued) 

Note that non-printing ASCII characters are printed in octal, enclosed by 
angle brackets (< > ). 



ATI/JSR @. SAVE 

$: 

. /CALL 4- 
ATI+CHAR i 
ATI+2 24050 i/ 

$= 

./ 24050 + 

17552 017550 + 

17553 016635 + 

17554 006331 ii 



print instruction at location ATI (Default instruction 

format) 

change to user symbol format. 

print current location and next two locations 

in symbol format. 

change to numeric format. 

print current location and next three locations 

in numeric format. 
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ERROR RESPONSES 

The debugger uses the following two error responses: 

SYMBOL MEANING EXAMPLES 



U 



Undefined symbol 



Do not understand; 
command attempt 
aborted. 



140G+-SST/U 

(where SST is not found) 

./LDA 1 PDF LDA 1 FPU 

(attempt to substitute unidentified 
symbol FF for user symbol PDF. ) 

ADD@? 
-1$R ? 

(in each case the command is 
improperly terminated, contains a 
given symbol in an illegal position, etc. ) 

AB$B? 

(An attempt to set a breakpoint 

at location AB when there are already 

8 breakpoints set. ) 
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OPERATION 

Debug III is loaded into memory with a user program or programs. Debug III can 
be loaded before or after the user program. 

Symbol Table 

To use symbolic addressing for local symbols when debugging, the program title 
must be specified to the debugger. User symbols are made known to the debugger 
by issuing the command: 

name % 

where: name is the title given the user program via the .TITL pseudo-op. 

The command can be issued as soon as the debugger and user program are loaded. 

By default, for both Stand-alone and DOS debuggers, the starting and terminating 
address of the symbol table are stored in the User Status Table in locations 402 
and 403 respectively, 

UST 



402 
403 



USTSS 
USTES 



The debugger is initialized to have the USTSS address, 402, in the symbol table 
pointer register ($Y). 

Users having versions of Stand-alone Debug III described in manual #093-000044-00 should 
note that this is a change from the pointer set in location 44 by the Relocatable Loader. 



44/ m 



ZMAX 



SST 



EST 



m is a pointer to ZMAX. m+1 
contains the address of the 
start of the symbol table. 
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Symbol Table (Continued) 

The Extended Relocatable Loader will set the proper pointer for this current version 
of Debug III. When using an older version of the relocatable loader, use the following 
procedure: 

After loading Debug III: 

1. Open location 44 to determine the value of m . 

2. Use the $Y command to open the symbol table pointer register. It will 
contain 000402. Change the value of the register to contain m +1 . 

3. Enter name% to make local symbols known to Debug III. 
Loading Stand-alone Debug III 

1. Load the Bootstrap loader as described in document 093-000002. 

2. Load the Binary Loader as described in document 093-000003. 

3. Load the Relocatable Loader or the Extended Relocatable Loader as described 
in document 093-000039. 

Following are the loader signals and standard user responses to load Debug III and 
the user program. User responses are underscored. 

SAFE = jj -<- carriage return gives a standard save of 200 locations. 



* 



* 



* 



2 <- Debug III should be in high speed tape reader for loading when this 

command is given. 

4S "*- command to load all symbols. 

2 ■«- user program should be in high speed tape reader ready for loading 

when this command is given. 

■<- additional programs can be loaded from the reader using *2 signal. 



<- command to print a loader map is usually given. 

NMAX 005640 

ZMAX 000255 

EST 004027 

SST 004077 



terminate loading. 



Using Stand-alone Debug III (Continued) 

4. User sets the data switches on console panel to DEBUG and presses START. 

5. User is now in the debugger and can issue any Debug commands. 



Stand-alone Debug 111 can be used with any NOVA configuration. However, in order 
to load the user program, symbol table, and Debug 111, a core configuration of at 
least 8K is recommended. 

Storage is allocated by the Relocatable Loader as shown below: 



During Loading 



After Termination of Loading 



grows down 



grows up 

A 



SAFE 



SYMBOL 
TABLE 



AVAILABLE 
SPACE 



LOADED 
USER'S 
ROUTINES 

AND 
DEBUG III 



LOADER 



top of memory- 




SAFE 



SYMBOL 
TABLE 



AVAILABLE 
SPACE 



pseudo 

address of 
location 
00000 



LOADED 
USER'S 
ROUTINES 

AND 
DEBUG III 
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Loading Debug 1 1 1 under DOS 

Debug III is supplied as a relocatable binary file within the library SYS. LB. The 
library is, in turn^ supplied as one file of dumped tape 088-000002. Debug III 
is loaded when the global switch /D is given in the RLDR command, e. g. , 

RLDR /D PROGl PR0G2 PROGS ^ 

DiaVlllfT TIT io VlTT /^Qf^ltl* 1»nJ»J ^tl il._ ^A.U - ^ rr, ,. . , .. 

^ g ^.x X13, ^y u>_xaui.L, iuducu ctiLcx iiic uuier programs. io aajust tne loading 

of Debug III, the name of the library file is put into the command line in the 
desired place: 

RLDR /D SYS. LB PROGl PR0G2 PROGS 1 

In this case Debug 111 will be loaded before all other programs. The starting 
address of Debug III is stored in the User Status Table in location 406. 

During loading the loader reserves lOg locations at the beginning of ZREL storage 
for the eight Debug III breakpoints. 



To start in the debugger, the user issues the command: 
DEB filename X 
where: filename is the name of the save file produced as output by the loader. 
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Storage is allocated by the Relocatable Loader under DOS as shown below: 



Loading 
Direction 



Disk 
Operating 
System 



top of memory 



Symbol 
Table 



Debug III 
(default position) 



User 
Program 
(NREL) 



User 
Tables 



NMAX 
SST 



EST 



1000 



User 
Program 
(ZREL) 



Reserved for 
DOS 



400 



50 



16 



SST - Start of Symbol 
Table. 



EST - End of Symbol Table. 
First address below 
the symbol table 
during loading. 

NMAX - The first available 
address for further 
loading. 



The Relocatable Loader permits 
loading beginning at location 
16. ZREL code begins at 
location 50. NREL code begins 
at location 1000. 

The Disk Operating System 
resides in upper memory 
only. The first 16 locations, 
0-15, are reserved for use 
by DOS. 
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